home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / p_msys / msys116.exe / MSYST.DOC < prev    next >
Text File  |  1993-12-05  |  6KB  |  122 lines
  1.                                 MSYST
  2.                         A User Terminal Program
  3.                      For use with TNC's or Modems
  4.                               By WA8BXN
  5.  
  6.                  (C) Copyright 1993 Hub Computers, Inc.
  7.  
  8.  
  9. This program and documentation is shareware. If you find it useful please
  10. send $5 (or more!) to support further development of this program and the
  11. MSYS BBS system. Distribution of this program will be through electronic
  12. means (the Cleveland Hamnet telephone BBS, for example). You may also 
  13. provide copies of the program and this documentation file to other 
  14. amateur radio operators interested in using it provided no changes are
  15. made to this documentation file nor the program. Make out your check to and
  16. send to:
  17. Michael Pechura
  18. 10809 Beechwood Drive
  19. Chesterland, OH 44026
  20.  
  21. Introduction
  22. ------------
  23.  
  24. This program was written primarily to allow use of the YAPP protocol
  25. provided by MSYS for file (binary or ASCII) uploading and downloading
  26. using either modem or tnc. It includes additional functions that make
  27. it usable as a simple terminal program for general use. It can be used
  28. with most TNC's that can be used with a terminal emulator program as
  29. well as most modems. Basic features include
  30.         * YAPP protocol support
  31.         * ASCII file capture
  32.         * ASCII file transmission
  33.         * 800 line scroll back buffer
  34.         * DOS Shell to run other programs without exiting MSYST
  35.         * Interrupt driven serial I/O with 16,000 byte input buffer
  36.         * Support for serial ports at any address and Int 0-7
  37.  
  38. Installation
  39. ------------
  40.  
  41. MSYST automatically will create a configuration file the first time you
  42. run it. It will ask you questions whose answers will be stored in the
  43. file MSYST.DEF. If you ever want to change any of your selections, all
  44. you have to do is delete MSYST.DEF and run MSYST to go through the
  45. configuration procedure again. The following options are configurable:
  46.         * Serial port address
  47.         * Interrupt number
  48.         * Serial port speed
  49.         * Text background color
  50.         * Text foreground color
  51.         * CTS support (Turn it on unless it causes program to hang)
  52.  
  53. Usage
  54. -----
  55.  
  56. For the most part what ever you type at the keyboard is sent to your 
  57. modem or TNC. The exceptions to this are the following keys:
  58.         F1 - Gives brief help information
  59.         F2 - Receive YAPP file after you tell BBS to send the file
  60.         F3 - Send YAPP file after you tell BBS to receive the file
  61.         F4 - Capture what appears on screen to a file
  62.         F5 - Send an ASCII file as if typed
  63.         F6 - End capture
  64.         F8 - Send password reply using PASSWORD.RMT file
  65.         F9 - DOS Shell (use exit command to return to MSYST)
  66.      Alt/X - Exit MSYST
  67.  
  68.         Arrow keys, Page Up or Down, Home, and End enter scroll back mode.
  69. To exit this mode, press Escape. F1 key (only F key that works when in
  70. scroll back mode) will give help summary. Alt/X will exit scroll mode and
  71. the program as well. While in scroll back mode incoming data is not 
  72. displayed but is accumulated in the 16,000 byte input buffer. When you
  73. exit scroll back mode it will be displayed. 
  74.  
  75.  
  76. Using YAPP Protocol to transfer files
  77. -------------------------------------
  78.  
  79. Using YAPP is particularly easy when you are using a modem connection to 
  80. MSYS. To download a file, type YD and the filename you want MSYS to send.
  81. Then press F2 and give the name you want the file to have on your system.
  82. You must complete this within 30 seconds of sending the YD command to MSYS.
  83. Next sit back and watch the file status be updated as the file is received.
  84.  
  85. To upload a file using a modem, type YU and the name the file will have
  86. on the MSYS system. When MSYS says its ok to send your file (note that
  87. you have to be specifically enabled to upload files) press F3. Give the
  88. name of the file you want to send and wait for it to be sent.
  89.  
  90. Using a TNC complicates things a bit because you have to switch your TNC
  91. into transparent mode for the actual data transfer. To receive a file,
  92. do the following:
  93.         Type YD followed by the name of the file on MSYS you want
  94.         When MSYS says to get ready to receive the file, type ^C to
  95.                 get back into your TNC's command mode
  96.         Type the command for your tnc to get it into transparent mode 
  97.                 (Usually TRANS)
  98.         Press F2 and give the name you want the file to have on your system
  99.         When the file transfer is complete, excape transparent mode
  100.                 (usually by typing ^C^C^C) to get back to your
  101.                 TNC's command mode.
  102.         Now type the command to get your TNC in normal conversation
  103.                 mode (usually CONV or K)
  104.  
  105. To send a file using a TNC, do the following:
  106.         Type YU and the name the file is to have on the MSYS system
  107.         When MSYS says its ok to send the file, type ^C to get to 
  108.                 the TNC command mode.
  109.         Get the TNC into transparent mode (see above)
  110.         Press F3 and enter the name of the file on your system
  111.         When the file transfer is complete, follow the instructions above
  112.  
  113.  
  114. If there is enough interest and support for this program it will be 
  115. improved in the future. Possible enhancements could include VGA support,
  116. compressed data transmission and "smart" interaction with MSYS. And of 
  117. course an improved documentation file. At this time I mainly want to
  118. provide a way to use the YAPP additions to MSYS over the phone (most
  119. of the other YAPP programs automate getting a TNC into transparent mode
  120. and thus can't easily be used with modems) and to test the waters to
  121. see what interest and support there may be for this program. Enjoy!
  122.